شارك المقالة
no image

WebView في Flutter باستخدام WebViewController وWebViewWidget

WebView في Flutter: انتقل من WebView القديم إلى Controller وWidget، واقصر التنقل على مصادر موثوقة.

WebView في Flutter يعرض صفحة ويب باستخدام محرك النظام، لكنه لا يحول أي موقع إلى تطبيق آمن تلقائيًا. تغيرت واجهة webview_flutter منذ أمثلة WebView(initialUrl) القديمة. يستخدم هذا الدرس WebViewController لتحميل الرابط وإدارة التنقل وWebViewWidget لعرض المحتوى، مع سياسة واضحة للنطاق المسموح.

إعداد المنصة قبل التشغيل

اختُبر الكود مع webview_flutter 4.14.1. راجع متطلبات المنصات في صفحة الحزمة بدل الاعتماد على رقم minSdk قديم. على Android تحقق من إذن INTERNET في manifest المناسب للإنتاج. هذه الحزمة ليست تنفيذ WebView موحدًا لكل منصات Flutter؛ اختبر المنصات التي يدعمها الإصدار.

التحكم في الروابط

يفحص allowedPage البروتوكول والنطاق والمنفذ وغياب بيانات الاعتماد. لا تكفي startsWith لأن عنوانًا مثل geecoders.com.evil.example ليس نطاق الموقع. يرفض المثال الوجهات الخارجية، ويمكن فتح وجهة موثوقة في المتصفح الخارجي عبر مسار منفصل بعد التحقق منها.

JavaScript والجسور الأصلية

يعطل المثال JavaScript افتراضيًا لأن عرض النص لا يحتاج منحه صلاحيات إضافية. إذا كانت صفحة موثوقة تحتاجه، فعله لسبب محدد وراجع أي JavaScriptChannel بعناية. لا تحمل HTML من مستخدم مجهول مع جسر يسمح بقراءة ملفات أو تنفيذ أوامر أصلية.

عرض الخطأ واختبار الرجوع

يعرض المثال خطأ للشاشة الرئيسية عند فشل التحميل بدل ترك صفحة بيضاء. أضف سياسة إعادة محاولة مناسبة ولا تخف أخطاء HTTP. اختبر زر الرجوع وسجل التنقل وتسجيل الدخول والروابط خارج النطاق على جهاز حقيقي؛ اختبارات الدالة هنا تتحقق من سياسة URL ولا تشغّل محرك WebView الأصلي.

الإعداد

flutter pub add webview_flutter

مثال تطبيقي

المقطع التالي مستقل في ملف Dart. اختُبر منطق Dart والواجهات المشار إليها، وتبقى إعدادات المنصة والتجربة على جهاز فعلي مطلوبة قبل النشر.

import 'package:flutter/material.dart';
import 'package:webview_flutter/webview_flutter.dart';

bool allowedPage(String value) {
  final uri = Uri.tryParse(value);
  return uri != null && uri.scheme == 'https' && uri.host == 'geecoders.com' &&
      uri.userInfo.isEmpty && uri.port == 443;
}

class ArticleWebPage extends StatefulWidget {
  const ArticleWebPage({super.key});
  @override
  State<ArticleWebPage> createState() => _ArticleWebPageState();
}
class _ArticleWebPageState extends State<ArticleWebPage> {
  late final WebViewController controller;
  String? error;
  @override
  void initState() {
    super.initState();
    controller = WebViewController()
      ..setJavaScriptMode(JavaScriptMode.disabled)
      ..setNavigationDelegate(NavigationDelegate(
        onNavigationRequest: (request) => allowedPage(request.url)
            ? NavigationDecision.navigate : NavigationDecision.prevent,
        onWebResourceError: (failure) {
          if (mounted && failure.isForMainFrame == true) {
            setState(() => error = 'تعذر تحميل الصفحة');
          }
        },
        onHttpError: (_) {
          if (mounted) setState(() => error = 'استجابة غير متوقعة من الموقع');
        },
      ))
      ..loadRequest(Uri.parse('https://geecoders.com/flutter_package/'));
  }
  @override
  Widget build(BuildContext context) => Scaffold(
    appBar: AppBar(title: const Text('المقال')),
    body: error == null ? WebViewWidget(controller: controller)
      : Center(child: Text(error!)),
  );
}

تطبيق WebView في Flutter في مشروعك

انتقل من WebView القديم إلى Controller وWidget، واقصر التنقل على مصادر موثوقة؛ لا تمنح JavaScript أو الجسور وصولًا أوسع من حاجة الصفحة.

مراجع الموضوع: pub.dev — webview_flutter

شاهد أيضًا
مقالات ذات صلة
🚫 مانع الإعلانات مفعل

يجب إيقاف مانع الإعلانات لاستكمال تصفح الموقع