همه چیز درباره مفهوم BuildContext  در برنامه نویسی فلاتر

زمانی که با فریمورک فلاتر به برنامه نویسی اپلیکیشن‌های موبایل می‌پردازید، احتمالاً با اصطلاحی به نام BuildContext برخورد خواهید کرد.

زمانی که با فریمورک فلاتر به برنامه نویسی اپلیکیشن‌های موبایل می‌پردازید، احتمالاً با اصطلاحی به نام BuildContext برخورد خواهید کرد.

این مفهوم، یکی از پایه‌ای‌ترین مفاهیم در فلاتر است که نقشی حیاتی در درخت ویجت‌ها، رندرینگ (پردازش و نمایش رابط کاربری)، و مسیریابی ایفا می‌کند.

در این مقاله، به بررسی این موضوع خواهیم پرداخت که BuildContext چیست، چگونه کار می‌کند، و چرا برای توسعه‌دهندگان فلاتر ضروری است.

BuildContext چیست؟

در فلاتر، BuildContext شیئی است که نمایانگر بخشی از درخت ویجت‌ها است که یک ویجت در آن قرار دارد.

در واقع، BuildContext یک ارجاع به موقعیت یک ویجت در سلسله مراتب ویجت‌ها است و نقشی اساسی در چگونگی ارتباط ویجت‌ها، مدیریت وضعیت (state)، و مسیریابی درون برنامه ایفا می‌کند.

هر ویجت در فلاتر BuildContext مخصوص به خود را دارد که هنگام ایجاد یا به‌روزرسانی ویجت، به آن منتقل می‌شود.

این BuildContext امکان دسترسی به داده‌های ویجت والد، مانند تم‌ها، محلی‌سازی‌ها، مسیریابی، یا حتی راهکارهای مدیریت وضعیت را فراهم می‌سازد.

کلاس BuildContext بخش جدایی‌ناپذیر متد build در فلاتر است. متد build تابعی است که نحوه رندر شدن ویجت را توصیف می‌کند.

این متد یک BuildContext را به عنوان ورودی دریافت می‌کند و یک ویجت جدید برمی‌گرداند که نشان‌دهنده ترکیب ویجت مورد نظر با استفاده از ویجت‌های ساده‌تر است. این فرآیند معمولاً با نام widget build(BuildContext context) شناخته می‌شود.

در یک اپلیکیشن فلاتر از BuildContext برای یافتن نزدیک‌ترین ویجت از یک نوع خاص استفاده می‌شود.

به عنوان مثال، اگر در ساختار درختی ویجت‌ها یک Scaffold وجود داشته باشد و بخواهید یک SnackBar نمایش دهید، با استفاده از BuildContext می‌توانید نزدیک‌ترین Scaffold را پیدا کنید.

علاوه بر این، BuildContext برای دسترسی به ویجت‌های به ارث رسیده (inherited widgets) نیز کاربرد دارد.

این ویجت‌ها نوع خاصی از ویجت‌ها هستند که بخشی از پیکربندی را برای ویجت‌های فرزند تعریف می‌کنند و در مدیریت کارآمد وضعیت (state) اپلیکیشن‌های Flutter نقش کلیدی ایفا می‌کنند.

مفهوم Widget Tree و Element Tree

برنامه نویسی فلاتر

در برنامه نویسی فلاتر، همه چیز یک ویجت است.

 ویجت‌ها توصیف می‌کنند که نمای مرتبط با آن‌ها با توجه به پیکربندی و وضعیت فعلی‌شان چگونه باید باشد.

وقتی تغییراتی در کد اعمال می‌کنید، ویجت، توصیف خود را بازسازی می‌کند و فریمورک Flutter تفاوت‌های بین توصیف جدید و قدیم را مقایسه کرده و رابط کاربری را بهینه به‌روزرسانی می‌کند.

درخت ویجت‌ها (Widget Tree) در فلاتر نمایشی سلسله‌مراتبی از تمام ویجت‌های موجود در اپلیکیشن است.

هر ویجت بخشی از این درخت محسوب می‌شود، یک ویجت والد دارد و می‌تواند چندین ویجت فرزند نیز داشته باشد.

برای مثال، قطعه کد زیر را در نظر بگیرید:

     void main() {
      runApp(
        MaterialApp(
          home: Scaffold(
            appBar: AppBar(
              title: Text('My Flutter App'),
            ),
            body: Text('Hello World'),
          ),
        ),
      );
    }

در این کد، MaterialApp ریشه درخت ویجت‌هاست. این ویجت، یک ویجت Scaffold به عنوان فرزند دارد.

Scaffold نیز به نوبه خود، یک ویجت AppBar (نوار بالایی) و یک ویجت Text (متن) را به عنوان فرزندانش شامل می‌شود.

این ساختار درختی به Flutter اجازه می‌دهد رابط کاربری را به صورت سلسله‌مراتبی و کارآمد مدیریت کند.

Element tree

درخت المنت‌ها (Element Tree) در فلاتر، ساختاری درختی از اشیاء المنت است که نمایانگر نمونه خاصی از یک ویجت در موقعیت مشخصی از درخت است.

هر ویجت در اپلیکیشن، یک المنت متناظر در این درخت دارد. این درخت برای فریمورک فلاتر ضروری است، چرا که در مدیریت چرخه حیات ویجت‌ها (مانند ایجاد، به‌روزرسانی و حذف) نقش کلیدی ایفا می‌کند.

فریمورک Flutter هنگام اجرای اپلیکیشن، درخت المنت‌ها را می‌سازد.

برای این کار، متد createElement را برای هر ویجت فراخوانی می‌کند تا المنت مربوط به آن را ایجاد کند. این متد بخشی از کلاس Widget است و توسط هر ویجت بازنویسی (override) می‌شود تا نوع صحیح المنت را برگرداند.

رابطه بین درخت ویجت‌ها و درخت المنت‌ها در فلاتر

در Flutter، درخت ویجت‌ها (Widget Tree) و درخت المنت‌ها (Element Tree) به شدت به هم مرتبط هستند، اما نقش‌های متفاوتی ایفا می‌کنند.

هر ویجت در درخت ویجت، یک اِلمان متناظر در درخت اِلمان دارد.

درخت ویجت تغییرناپذیر است، به این معنی که ویجت‌های موجود در درخت ویجت غیرقابل تغییر هستند. آن‌ها را نمی‌توان به‌روزرسانی کرد. هنگامی که وضعیت (state) یک برنامه تغییر می‌کند، ویجت‌ها نابود و دوباره ایجاد می‌شوند.

از طرف دیگر، درخت اِلمان تغییرپذیر است. اِلمان‌های موجود در درخت اِلمان در طول زمان پایدار می‌مانند و می‌توانند به‌روزرسانی شوند.

هنگامی که وضعیت یک برنامه تغییر می‌کند، فریم‌ورک فلاتر اِلمان‌های موجود در درخت اِلمان را به‌روزرسانی می‌کند، به جای اینکه آن‌ها را نابود و دوباره ایجاد کند. این کار کارآمدتر است و منجر به عملکرد بهتر برای اپلیکیشن فلاتر شما می‌شود.

نحوه استفاده ویجت‌ها از BuildContext

هر متد build ویجت، یک پارامتر BuildContext به نام context دارد.

این آرگومان context توسط فریم‌ورک ارائه می‌شود و تبدیل به BuildContext برای ویجتی خواهد شد که توسط متد build برگردانده می‌شود.

آرگومان BuildContext، دسترسی شما به موقعیت ویجت در درخت ویجت‌ها است.

این موقعیت برای جستجوی ویجت‌های ارث‌بری‌شده (inherited widgets) استفاده می‌شود.

این همان BuildContext است که شما به متدهایی مانند Theme.of یا MediaQuery.of ارسال می‌کنید.

نقش متد Build در ویجت‌ها

متد build هر بار که فریم‌ورک نیاز به رندر کردن ویجت دارد یا زمانی که پیکربندی ارائه شده به متد build تغییر می‌کند، فراخوانی می‌شود.

متد build یک BuildContext را به عنوان ورودی می‌گیرد و یک ویجت جدید برمی‌گرداند. این اغلب به عنوان متد widget build(BuildContext context) نامیده می‌شود.

کاربردهای اصلی BuildContext

BuildContext عملکردهای کلیدی متعددی را در برنامه‌های فلاتر ارائه می‌دهد. بیایید آن‌ها را به تفکیک بررسی کنیم:

پیکربندی ویجت

ویجت‌های فلاتر با استفاده از BuildContext پیکربندی می‌شوند. در متد build() یک ویجت، پارامتر context برای ایجاد ویجت‌ها و پیکربندی آن‌ها بر اساس موقعیت‌شان در درخت ویجت‌ها استفاده می‌شود.

class MyWidget extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return Container(
      child: Text('Hello, Flutter!'),
    );
  }
}

اگرچه در اینجا به طور صریح از BuildContext استفاده نمی‌شود، اما به صورت خودکار به متد build() ارسال می‌شود، و ویجت می‌تواند در هر زمان به آن دسترسی داشته باشد.

دسترسی به تم

فلاتر متد Theme.of(context) را ارائه می‌دهد که به ویجت‌ها اجازه می‌دهد به تم تعریف‌شده در سطوح بالاتر درخت ویجت‌ها دسترسی پیدا کنند.

بدون BuildContext، اعمال یکپارچه و هماهنگ استایل‌ها در سراسر یک برنامه غیرممکن خواهد بود.

class ThemedButton extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    final theme = Theme.of(context);  // Access current theme
    return ElevatedButton(
      style: ElevatedButton.styleFrom(primary: theme.primaryColor),
      onPressed: () {},
      child: Text('Press Me'),
    );
  }
}

محلی‌سازی (Localization)

اپلیکیشن‌های فلاتر اغلب نیاز دارند تا خود را با زبان‌ها و مناطق مختلف سازگار کنند. با استفاده از BuildContext، می‌توانید به راحتی به منابع محلی‌سازی مانند رشته‌ها و قالب‌بندی‌های محلی‌شده دسترسی پیدا کنید.

از Localizations.of(context, type) برای دسترسی به داده‌های محلی‌سازی استفاده می‌شود.

class LocalizedText extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return Text(AppLocalizations.of(context)!.helloWorld);
  }
}

مدیریت State

برای راهکارهای مدیریت State در فلاتر مانند Provider، Riverpod، BuildContext نقشی حیاتی در دسترسی و دستکاری داده‌ها در درخت ویجت‌ها ایفا می‌کند.

این امکان را به ویجت‌ها می‌دهد تا وضعیت نزدیک‌ترین جد خود را به دست آورند. مثال با استفاده از Provider:

class UserNameWidget extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    final userName = Provider.of<UserModel>(context).name;
    return Text(userName);
  }
}

مفاهیم پیشرفته BuildContext

در حالی که کاربردهای ذکر شده در بالا رایج هستند، BuildContext هنگام شروع به ساخت برنامه‌های بزرگتر و پیچیده‌تر، عمق بیشتری ارائه می‌دهد. بیایید برخی از کاربردهای پیشرفته را بررسی کنیم:

درک مرزهای درخت ویجت

BuildContext را نمی‌توان در سراسر مرزهای درخت ویجت که به طور جداگانه بازسازی می‌شوند، استفاده کرد.

این یک اشتباه رایج برای توسعه‌دهندگان تازه‌کار فلاتر است که سعی می‌کنند از یک عملیات ناهمزمان (asynchronous) یا از خارج از فرآیند build، به BuildContext یک ویجت دسترسی پیدا کنند. مثال - استفاده نادرست:

void doSomething() async {
  await Future.delayed(Duration(seconds: 2));
  Navigator.of(context).pushNamed('/next');  // Error: Cannot use context here
}

روش صحیح این است که اطمینان حاصل کنید BuildContext استفاده‌شده، همچنان بخشی از درخت ویجت فعال در هنگام انجام اقدامات باشد.

یافتن نزدیک‌ترین والد

BuildContext در فلاتر به ویجت‌ها اجازه می‌دهد تا نزدیک‌ترین ویجت‌های جد خود را در درخت جستجو کنند. این اغلب زمانی استفاده می‌شود که ویجت‌ها نیاز به ارث‌بری داده یا رفتار از ویجت‌های سطح بالاتر دارند.

به عنوان مثال، برای یافتن نزدیک‌ترین ویجت Scaffold:

ScaffoldState scaffold = Scaffold.of(context);
scaffold.showSnackBar(SnackBar(content: Text('Hello!')));

با این حال، رویکرد بهتر در برنامه‌های مدرن فلاتر، استفاده از ScaffoldMessenger برای نمایش اسنک‌بارها (snackbar) است:

ScaffoldMessenger.of(context).showSnackBar(
  SnackBar(content: Text('Hello!'))
);

نتیجه

BuildContext یکی از حیاتی‌ترین اجزاء در فلاتر است که به ویجت‌ها توانایی برقراری ارتباط با فریم‌ورک، دسترسی به داده‌های اشتراکی، مدیریت وضعیت، و مسیریابی بین صفحات را می‌دهد.

درک استفاده صحیح از BuildContext—همراه با محدودیت‌های آن—به شما کمک می‌کند تا برنامه‌های فلاتر کارآمدتر، خواناتر، و قابل نگهداری‌تری بنویسید.

چه در حال مدیریت مسیریابی باشید، چه دسترسی به تم‌ها و محلی‌سازی، چه مدیریت وضعیت، و چه انجام عملیات پیشرفته بر روی درخت ویجت‌ها، تسلط بر BuildContext کلید تبدیل شدن به یک توسعه‌دهنده متخصص فلاتر است.

دیدگاه‌ها (0)

    دیدگاه خود را بنویسید

    ایمیل شما نمایش داده نمی‌شود. دیدگاه پس از تأیید نمایش داده می‌شود.