comunicmobile/lib/utils/ui_utils.dart

import 'package:comunic/helpers/preferences_helper.dart';
import 'package:comunic/ui/routes/full_screen_image.dart';
import 'package:comunic/ui/widgets/dialogs/auto_sized_dialog_content_widget.dart';
import 'package:comunic/utils/intl_utils.dart';
import 'package:flutter/material.dart';
import 'package:html/parser.dart';

/// User interface utilities
///
/// @author Pierre HUBERT

/// Build centered progress bar
Widget buildCenteredProgressBar() {
  return Center(
    child: CircularProgressIndicator(),
  );
}

/// Build and return a full loading page
Widget buildLoadingPage({
  bool showAppBar = false,
  String routeTitle,
}) {
  return Scaffold(
    appBar: showAppBar
        ? AppBar(
            title: routeTitle == null ? null : Text(routeTitle),
          )
        : null,
    body: buildCenteredProgressBar(),
  );
}

/// Build and return an error card
Widget buildErrorCard(String message,
    {List<Widget> actions, bool hide = false}) {
  if (hide) return Container();

  return Card(
    elevation: 2.0,
    color: Colors.red,
    child: Padding(
      padding: const EdgeInsets.all(8.0),
      child: Row(
        children: <Widget>[
          Padding(
            padding: const EdgeInsets.only(right: 8.0),
            child: Icon(
              Icons.error,
              color: Colors.white,
            ),
          ),
          Flexible(
            child: Text(
              message,
              style: TextStyle(color: Colors.white),
              maxLines: null,
            ),
          ),
          Row(
            children: actions == null ? <Widget>[] : actions,
          )
        ],
      ),
    ),
  );
}

/// Show an image with a given [url] in full screen
void showImageFullScreen(BuildContext context, String url) {
  Navigator.of(context).push(MaterialPageRoute(builder: (c) {
    return FullScreenImageRoute(url);
  }));
}

/// Show simple snack
void showSimpleSnack(BuildContext context, String message) {
  Scaffold.of(context).showSnackBar(SnackBar(content: Text(message)));
}

/// Show an alert dialog to ask the user to enter a string
///
/// Returns entered string if the dialog is confirmed, null else
Future<String> askUserString({
  @required BuildContext context,
  @required String title,
  @required String message,
  @required String defaultValue,
  @required String hint,
  int maxLength = 200,
}) async {
  assert(context != null);
  assert(title != null);
  assert(message != null);
  assert(defaultValue != null);
  assert(hint != null);
  assert(maxLength != null);

  TextEditingController controller = TextEditingController(text: defaultValue);

  final confirm = await showDialog<bool>(
      context: context,
      builder: (c) => AlertDialog(
            title: Text(title),
            content: AutoSizeDialogContentWidget(
              child: Column(
                children: <Widget>[
                  Text(message),
                  TextField(
                    controller: controller,
                    maxLines: null,
                    maxLength: maxLength,
                    keyboardType: TextInputType.text,
                    decoration: InputDecoration(
                      labelText: hint,
                      alignLabelWithHint: true,
                    ),
                  )
                ],
              ),
            ),
            actions: <Widget>[
              FlatButton(
                child: Text(tr("Cancel").toUpperCase()),
                onPressed: () => Navigator.pop(c, false),
              ),
              FlatButton(
                child: Text(tr("OK")),
                onPressed: () => Navigator.pop(c, true),
              ),
            ],
          ));

  if (confirm == null || !confirm) return null;

  return controller.text;
}

/// Show an alert dialog to get user confirmation for something
///
/// Return value of this function is never null
Future<bool> showConfirmDialog({
  @required BuildContext context,
  String title,
  @required String message,
}) async {
  if (title == null) title = tr("Confirm operation");

  // Avoid potential theme issues
  var ctx = Scaffold.of(context).context;
  ctx = ctx != null ? ctx : context;

  final result = await showDialog<bool>(
      context: ctx,
      builder: (c) => AlertDialog(
            title: Text(title),
            content: Text(message),
            actions: <Widget>[
              FlatButton(
                onPressed: () => Navigator.pop(context, false),
                child: Text(tr("Cancel").toUpperCase()),
              ),
              FlatButton(
                onPressed: () => Navigator.pop(context, true),
                child: Text(
                  tr("Confirm").toUpperCase(),
                  style: TextStyle(color: Colors.red),
                ),
              ),
            ],
          ));

  return result != null && result;
}

/// Smart [InputCounterWidgetBuilder] that show text limit only when some
/// text has already been entered by the user
Widget smartInputCounterWidgetBuilder(
  BuildContext context, {
  @required int currentLength,
  @required int maxLength,
  @required bool isFocused,
}) =>
    currentLength > 0 ? Text("$currentLength/$maxLength") : Container();

/// Parse an HTML String to decode special characters
String htmlDecodeCharacters(String input) {
  if (input == null || input == "") return "";

  return parse(input).documentElement.text;
}

const darkAccentColor = Colors.white70;
const darkerAccentColor = Colors.white30;

/// Check out whether dark theme is enabled or not
bool darkTheme() => preferences().getBool(PreferencesKeyList.ENABLE_DARK_THEME);

/// Check out whether we use tablet mode or not
bool isTablet(BuildContext context) =>
    MediaQuery.of(context).size.width >= 1024;

/// Show about Comunic dialog
void showAboutAppDialog(BuildContext context) {
  showAboutDialog(
      context: context,
      applicationName: "Comunic",
      children: <Widget>[
        Text(
          tr("Comunic is a free and OpenSource social network that respect your privacy."),
          textAlign: TextAlign.center,
        ),
        SizedBox(
          height: 20,
        ),
        Text(
          "Application built by Pierre Hubert",
          textAlign: TextAlign.center,
        ),
      ]);
}