A Bollywood actress who starred in India's highest-grossing movie said she is quitting acting because it is incompatible with her Islamic faith, sparking a social media storm.