Web-браузер

extra_toc

Web-браузер - это специальный контейнер для отображения веб-содержимого. Это идеальный способ для отображения информации со сложным форматированием, онлайн страниц и т.д.

Комопнент Web-браузер представлен классом FGX.WebBrowser.TfgWebBrowser.

Загрузка локальной HTML страницы

Если вам нужно создать HTML страницу или же вы хотите загрузить HTML страницу из локального файла, то можете воспользоваться методом TfgWebBrowser.LoadHTML.


uses
  System.SysUtils, FGX.Application, FGX.Dialogs, FGX.Log;

procedure TForm5.fgFormCreate(Sender: TObject);
var
  HTML: TStringList;
begin
  HTML := TStringList.Create;
  try
    HTML.Add('<html>');
    HTML.Add('<body>');
    HTML.Add('<p style="font-size: 30px; margin-top: 40px">');
    HTML.Add('Hello from FGX Native local HTML page!');
    HTML.Add('</p>');
    HTML.Add('</body>');
    HTML.Add('</html>');
    fgWebBrowser1.LoadHTML(HTML.Text, 'http://mylocal');
  finally
    FreeAndNil(HTML);
  end;
end;

Отслеживание загрузки URL

Компонент TfgWebBrowser поддерживает набор событий для отслеживания стадий загрузки ресурсов по URL:

  1. OnStartLoading - началась загрузка указанного ресурса по URL
  2. OnFinishLoading- закончилась загрузка указанного ресурса по URL
  3. OnErrorLoading - при загрузке ресурса по указанному URL произошла ошибка.

В любой момент вы можете остановить текущую загрузку страницы, вызвав метод StopLoading. Для перезагрузки содержимого используйте метод Reload.

Выполнение JavaScript

Компонент TfgWebBrowser поддерживает работу с JavaScript. Это позволяет вам выполнить ваш JavaScript код и вернуть вам результат.

Этот простой код показывает получение URL текущей страницы через JavaScript:


  fgWebBrowser1.EvaluateJavaScript('document.URL', procedure (const AResult: string) begin
    TfgToast.Show(AResult);
  end);

Перехват загрузки по Url

Если вы хотите перехватить загрузку ресурса по URL, вы можете воспользоваться событием OnDecideLoadUrl.

Например, если вы локально отображаете справку, сделанную на базе набора HTML страниц с картинками, вы возможно, захотите сделать открытие картинок в отдельном окне. Вы можете добавить каждой картинке в разметке свою произвольную ссылку, а затем перехватывать нажатие на эту ссылку в событии OnDecideLoadUrl. Это событие также позволяет отклонить загрузку ресурса по URL. 

Прокрутка

Web-браузер предлагает набор методов и событий для управления прокруткой содержимого.

  1. ScrollBy - прокручивает содержимое на указанное смещение.
  2. ScrollTo - прокручивает содержимое в указанное смещение.
  3. ScrollTop - прокручивает содержимое к началу.
  4. ScrollBottom - прокручивает содержимое к концу.
  5. ContentSize - размер (ширина, высота) загруженного содержимого.
  6. ContentOffset - Текущее смещение прокрутки содержимого.